Summary

Bump yandex_ynison plugin provider to v2.2.9. The diff against dev introduces a real two-way state-sync layer for the experimental handoff playback mode and adds an opt-in stream-mode UI integration so MA's player card renders fully while a PluginSource is active.

Source: trudenboy/ma-provider-yandex-ynison@v2.2.9.

Highlights

Handoff state-sync

Two-way sync between the Yandex Music app and MA's player queue is driven by an explicit HandoffPhase FSM (IDLE / ACTIVATING / PLAYING / PAUSED / ENDING).

• Centralised dispatcher: _handoff_activate → _apply_track_change / _apply_idle_resume / _apply_same_track_sync.
• Idempotency cache (1 s TTL); _cancel_pending_play_media() cancels the in-flight play_media task before issuing a new one. The task is created via self.mass.create_task(...) so it is tracked by the MusicAssistant instance and auto-cancelled on stop/reload.
• Pause / resume routed through cmd_pause / cmd_play (avoids the queue's _watch_pause watchdog dropping to IDLE on long pauses). The same-URI-paused cmd_play resume snapshots _drift_suppress_until / _expected_phase before the await and rolls them back on Exception, symmetric with the REPLACE-issuing branches; a failed resume no longer leaves the session stuck in ACTIVATING.
• Same-URI resume goes via play_media(REPLACE) + seek wrapped in cmd_pause / seek / cmd_play (avoids the audible 0-then-jump).
• _prefetch_format_for_track runs in the background (mass.create_task(...)) on track change instead of blocking play_media — the prefetch is cosmetic in handoff (only primes MA's stream-detail cache; _normalized_format is never used here), so the up-to-2.5 s latency per track change is gone.
• Natural-end auto-advance: PLAYING → IDLE queue-state transition, gated on _expected_phase == PLAYING and _is_at_natural_end_of_track. Heartbeat-side polling (≤ 5 s) as a fallback when MA's event bus drops the transition.
• Echo classification: author-only AND check on both queue.version.device_id and status.version.device_id. Lamport-style watermarks are intentionally not used — Ynison documents version.version as random(int64) and re-stamps it.
• Reconnect settle window (2 s) drops the first inbound state after WS reconnect; _connect_state always sends a fresh initial state.
• Shared helpers used by both stream + handoff: _classify_drift (queue-rebuild guard, prevents stream mode from treating a Ynison progress=0 echo as a seek), _pick_resume_position.
• _handoff_pause echoes paused=True to Ynison immediately and bumps the heartbeat watermark so the next tick doesn't race the user's pause.

Stream-mode MA UI integration (opt-in)

New advanced config — enable_ui_integration (default off) — publishes a frontend-only fake queue under the provider's instance_id, so MA's UI renders the seek bar, signal-chain panel, and quality indicator while a PluginSource is active.

• _register_plugin_queue fires QUEUE_ADDED / QUEUE_UPDATED events without touching player_queues._queues — backend command routing stays on the PluginSource callbacks.
• _set_player_output_format stamps a real AudioFormat instance (not a plain dict) on player.extra_data["output_format"], matching MA core's contract (controllers/streams/audio.py:get_player_filter_params writes AudioFormat; DSPDetails.output_format: AudioFormat | None). Cleared in unload() and _clear_active_player.
• _signal_seek_to_frontend snaps the frontend bar via a public QUEUE_TIME_UPDATED event (no private-attribute writes).
• Queue state derived from the live YnisonState.is_paused flag so pause / resume reflect immediately.
• Off by default because the integration relies on private frontend behaviours and can interfere with "Play Now" on local content while the source is active.
• Multi-user limitation: MA's websocket gate (controllers/webserver/websocket_client.py:444-454) drops QUEUE_* events whose event.object_id is not in the user's player_filter. Our events use instance_id (matching player.active_source for the frontend's queue lookup), so users with a restricted player_filter see an empty player card. Switching object_id to player_id would pass the filter but break the lookup for everyone. A clean fix needs an MA-core carve-out for plugin source ids (mirroring the existing _sendspin_player_id exception) or a frontend change to route QUEUE_* by data.queue_id — both out of scope for this PR. Admin / unrestricted users are unaffected; the integration is opt-in.

Stream-mode reconnect resilience

• _send_progress_to_ynison short-circuits when paused=False and the server-side queue is empty (current_track_id is None). Without this, every 5 s _sync_progress tick after a reconnect that lands on a stale empty-queue state fired update_playing_status(paused=False), which Ynison rejects with error 400030001 ("Player is not paused, but queue is probably empty") and closes the WebSocket — ping-ponging through reconnects (sometimes escalating into a 300100002 rebalance loop) for minutes. Observed live and root-caused. paused=True is still sent (one-sided guard; the server accepts that combination).

Config UX

• playback_mode and Device name in Yandex Music (publish_name) moved out of the advanced section.
• New advanced toggle enable_ui_integration (hidden in handoff mode).

Stats

10 files changed, ≈3000 insertions(+), ≈90 deletions(-) (vs dev). One new test file: tests/providers/yandex_ynison/test_provider_handoff.py (≈1000 lines). 285 unit tests, ruff and mypy clean on the source repo.

Test plan

• Unit tests, ruff, mypy — green
• Live-tested in both playback_mode: stream and playback_mode: handoff: track change, pause / resume (short and long), next / prev, seek (forward and backward), mid-track handoff from the Yandex Music app, natural-end auto-advance.
• Stream-mode UI integration live-tested with multiple track formats (FLAC 44.1/16, 44.1/24, 48/24, AAC 44.1/16). Toggle on/off paths verified.
• Reconnect cascade fix verified against the live 400030001 scenario (no more WS ping-pong on empty-queue post-reconnect states).

CI sync

Published via trudenboy/ma-provider-tools/reusable-sync-to-fork.yml (target upstream/yandex_ynison).